home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / man / manpages.zoo / ls.1 < prev    next >
Encoding:
Text File  |  1991-11-11  |  7.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4. LS(1L)                                                     LS(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      ls, dir, vdir - list contents of directories
  10.  
  11. SYNOPSIS
  12.      ls [-abcdgiklmnpqrstuxABCFLNQRSUX1] [-w cols] [-T cols] [-I
  13.      pattern] [+all] [+escape] [+directory] [+inode] [+kilobytes]
  14.      [+numeric-uid-gid] [+hide-control-chars] [+reverse] [+size]
  15.      [+width=cols] [+tabsize=cols] [+almost-all] [+ignore-
  16.      backups] [+classify] [+file-type] [+ignore=pattern]
  17.      [+dereference] [+literal] [+quote-name] [+recursive]
  18.      [+sort={none,time,size,extension}]
  19.      [+format={long,verbose,commas,across,vertical,single-
  20.      column}] [+time={atime,access,use,ctime,status}] [path...]
  21.  
  22. DESCRIPTION
  23.      This manual page documents the GNU version of ls.  dir and
  24.      vdir are versions of ls with different default output for-
  25.      mats.  These programs list each given file or directory
  26.      path.  Directory contents are sorted alphabetically.  For
  27.      ls, files are by default listed in columns, sorted verti-
  28.      cally, if the standard output is a terminal; otherwise they
  29.      are listed one per line.  For dir, files are by default
  30.      listed in columns, sorted vertically.  For vdir, files are
  31.      by default listed in long format.
  32.  
  33.      OPTIONS
  34.  
  35.      -_✓a, +_✓a_✓l_✓l
  36.           List all files in directories, including all files that
  37.           start with `.'.
  38.  
  39.      -_✓b, +_✓e_✓s_✓c_✓a_✓p_✓e
  40.           Quote nongraphic characters in file names using alpha-
  41.           betic and octal backslash sequences like those used in
  42.           C.
  43.  
  44.      -_✓c, +_✓t_✓i_✓m_✓e=_✓c_✓t_✓i_✓m_✓e, +_✓t_✓i_✓m_✓e=_✓s_✓t_✓a_✓t_✓u_✓s
  45.           Sort directory contents according to the files' status
  46.           change time instead of the modification time.  If the
  47.           long listing format is being used, print the status
  48.           change time instead of the modification time.
  49.  
  50.      -_✓d, +_✓d_✓i_✓r_✓e_✓c_✓t_✓o_✓r_✓y
  51.           List directories like other files, rather than listing
  52.           their contents.
  53.  
  54.      -_✓g   Ignored; for Unix compatibility.
  55.  
  56.      -_✓i, +_✓i_✓n_✓o_✓d_✓e
  57.           Print the index number of each file to the left of the
  58.           file name.
  59.  
  60.  
  61.  
  62.  
  63. Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LS(1L)                                                     LS(1L)
  71.  
  72.  
  73.  
  74.      -_✓k, +_✓k_✓i_✓l_✓o_✓b_✓y_✓t_✓e_✓s
  75.           If file sizes are being listed, print them in kilo-
  76.           bytes.  This overrides the environment variable
  77.           POSIX_ME_HARDER.
  78.  
  79.      -_✓l, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓l_✓o_✓n_✓g, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓v_✓e_✓r_✓b_✓o_✓s_✓e
  80.           In addition to the name of each file, print the file
  81.           type, permissions, number of hard links, owner name,
  82.           group name, size in bytes, and timestamp (the modifica-
  83.           tion time unless other times are selected).
  84.  
  85.      -_✓m, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓c_✓o_✓m_✓m_✓a_✓s
  86.           List files horizontally, with as many as will fit on
  87.           each line, separated by commas.
  88.  
  89.      -_✓n, +_✓n_✓u_✓m_✓e_✓r_✓i_✓c-_✓u_✓i_✓d-_✓g_✓i_✓d
  90.           List the numeric UID and GID instead of the names.
  91.  
  92.      -_✓p   Append a character to each file name indicating the
  93.           file type.
  94.  
  95.      -_✓q, +_✓h_✓i_✓d_✓e-_✓c_✓o_✓n_✓t_✓r_✓o_✓l-_✓c_✓h_✓a_✓r_✓s
  96.           Print question marks instead of nongraphic characters
  97.           in file names.
  98.  
  99.      -_✓r, +_✓r_✓e_✓v_✓e_✓r_✓s_✓e
  100.           Sort directory contents in reverse order.
  101.  
  102.      -_✓s, +_✓s_✓i_✓z_✓e
  103.           Print the size of each file in 1K blocks to the left of
  104.           the file name.  If the environment variable
  105.           POSIX_ME_HARDER is set, 512-byte blocks are used
  106.           instead.
  107.  
  108.      -_✓t, +_✓s_✓o_✓r_✓t=_✓t_✓i_✓m_✓e
  109.           Sort directory contents by timestamp instead of alpha-
  110.           betically, with the newest files listed first.
  111.  
  112.      -_✓u, +_✓t_✓i_✓m_✓e=_✓a_✓t_✓i_✓m_✓e, +_✓t_✓i_✓m_✓e=_✓a_✓c_✓c_✓e_✓s_✓s, +_✓t_✓i_✓m_✓e=_✓u_✓s_✓e
  113.           Sort directory contents according to the files' last
  114.           access time instead of the modification time.  If the
  115.           long listing format is being used, print the last
  116.           access time instead of the modification time.
  117.  
  118.      -_✓x, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓a_✓c_✓r_✓o_✓s_✓s, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓h_✓o_✓r_✓i_✓z_✓o_✓n_✓t_✓a_✓l
  119.           List the files in columns, sorted horizontally.
  120.  
  121.      -_✓A, +_✓a_✓l_✓m_✓o_✓s_✓t-_✓a_✓l_✓l
  122.           List all files in directories except for `.' and `..'.
  123.  
  124.      -_✓B, +_✓i_✓g_✓n_✓o_✓r_✓e-_✓b_✓a_✓c_✓k_✓u_✓p_✓s
  125.           Do not list files that end with `~', unless they are
  126.  
  127.  
  128.  
  129. Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LS(1L)                                                     LS(1L)
  137.  
  138.  
  139.  
  140.           given on the command line.
  141.  
  142.      -_✓C, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓v_✓e_✓r_✓t_✓i_✓c_✓a_✓l
  143.           List files in columns, sorted vertically.
  144.  
  145.      -_✓F, +_✓c_✓l_✓a_✓s_✓s_✓i_✓f_✓y
  146.           Append a character to each file name indicating the
  147.           file type.  For regular files that are executable,
  148.           append a `*'.  The file type indicators are `/' for
  149.           directories, `@' for symbolic links, `|' for FIFOs, `='
  150.           for sockets, and nothing for regular files.
  151.  
  152.      -_✓L, +_✓d_✓e_✓r_✓e_✓f_✓e_✓r_✓e_✓n_✓c_✓e
  153.           List the files linked to by symbolic links instead of
  154.           listing the contents of the links.
  155.  
  156.      -_✓N, +_✓l_✓i_✓t_✓e_✓r_✓a_✓l
  157.           Do not quote file names.
  158.  
  159.      -_✓Q, +_✓q_✓u_✓o_✓t_✓e-_✓n_✓a_✓m_✓e
  160.           Enclose file names in double quotes and quote non-
  161.           graphic characters as in C.
  162.  
  163.      -_✓R, +_✓r_✓e_✓c_✓u_✓r_✓s_✓i_✓v_✓e
  164.           List the contents of all directories recursively.
  165.  
  166.      -_✓S, +_✓s_✓o_✓r_✓t=_✓s_✓i_✓z_✓e
  167.           Sort directory contents by file size instead of alapha-
  168.           betically, with the largest files listed first.
  169.  
  170.      -_✓U, +_✓s_✓o_✓r_✓t=_✓n_✓o_✓n_✓e
  171.           Do not sort directory contennts.
  172.  
  173.      -_✓X, +_✓s_✓o_✓r_✓t=_✓e_✓x_✓t_✓e_✓n_✓s_✓i_✓o_✓n
  174.           Sort directory contents alphabetically by file exten-
  175.           sion (characters after the last `.'); files with no
  176.           extension are sorted first.
  177.  
  178.      -_✓1, +_✓f_✓o_✓r_✓m_✓a_✓t=_✓s_✓i_✓n_✓g_✓l_✓e-_✓c_✓o_✓l_✓u_✓m_✓n
  179.           List one file per line.
  180.  
  181.      -_✓w, +_✓w_✓i_✓d_✓t_✓h _✓c_✓o_✓l_✓s
  182.           Assume the screen is _✓c_✓o_✓l_✓s columns wide.  The default is
  183.           taken from the terminal driver if possible; otherwise
  184.           the environment variable COLUMNS is used if it is set;
  185.           otherwise the default is 80.
  186.  
  187.      -_✓T, +_✓t_✓a_✓b_✓s_✓i_✓z_✓e _✓c_✓o_✓l_✓s
  188.           Assume that each tabstop is _✓c_✓o_✓l_✓s columns wide.  The
  189.           default is 8.
  190.  
  191.      -_✓I, +_✓i_✓g_✓n_✓o_✓r_✓e _✓p_✓a_✓t_✓t_✓e_✓r_✓n
  192.  
  193.  
  194.  
  195. Page 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LS(1L)                                                     LS(1L)
  203.  
  204.  
  205.  
  206.           Do not list files whose names match the shell pattern
  207.           _✓p_✓a_✓t_✓t_✓e_✓r_✓n unless they are given on the command line.  As
  208.           in the shell, an initial `.' in a filename does not
  209.           match a wildcard at the start of _✓p_✓a_✓t_✓t_✓e_✓r_✓n.
  210.  
  211. BUGS
  212.      On BSD systems, the -_✓s option reports sizes that are half
  213.      the correct values for files that are NFS-mounted from HP-UX
  214.      systems.  On HP-UX systems, it reports sizes that are twice
  215.      the correct values for files that are NFS-mounted from BSD
  216.      systems.  This is due to a flaw in HP-UX; it also affects
  217.      the HP-UX ls program.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Page 4
  262.  
  263.  
  264.  
  265.